MCP 문서 관리

메뉴

Image Generation

Image Generation

Image Generation MCP 서버는 Replicate Flux 모델을 활용한 이미지 생성 기능을 제공합니다. 이 서버를 통해 LLM은 텍스트 프롬프트를 기반으로 다양한 스타일의 고품질 이미지를 생성할 수 있습니다. 텍스트-이미지 변환 모델을 사용하여 사용자 지정 가능한 이미지 생성, 스타일 적용, 이미지 변형 등 다양한 시각적 콘텐츠 제작이 가능합니다.

특징

  • 텍스트 기반 이미지 생성: 자연어 설명에서 고품질 이미지 생성
  • 다양한 스타일 지원: 사실적, 추상적, 예술적 등 다양한 스타일 적용
  • 이미지 크기 및 형식 제어: 해상도, 비율, 출력 형식 조정
  • 프롬프트 최적화: 효과적인 이미지 생성을 위한 프롬프트 개선
  • 배치 처리: 여러 이미지의 동시 생성 및 관리
  • 모델 선택: 다양한 Replicate 모델과 매개변수 조정
  • 이미지 수정: 기존 이미지 변형 및 스타일 전이
  • 합성 및 인페인팅: 이미지 합성 및 영역 재생성

API

도구

기본 이미지 생성 도구

  • generate_image: 텍스트 프롬프트에서 이미지 생성
  • 입력: 텍스트 프롬프트, 이미지 크기, 모델 매개변수
  • 출력: 생성된 이미지 URL 또는 바이너리 데이터

  • generate_variants: 기존 이미지의 변형 생성

  • 입력: 기준 이미지, 변형 강도, 변형 수
  • 출력: 생성된 변형 이미지 배열

  • batch_generate: 여러 프롬프트의 일괄 처리

  • 입력: 프롬프트 배열, 공통 설정
  • 출력: 생성된 이미지 배열

고급 생성 도구

  • style_transfer: 스타일 전이 적용
  • 입력: 콘텐츠 이미지, 스타일 이미지 또는 스타일 설명
  • 출력: 스타일이 적용된 이미지

  • image_inpainting: 이미지 영역 재생성

  • 입력: 기본 이미지, 마스크, 채우기 프롬프트
  • 출력: 재생성된 이미지

  • image_upscaling: 이미지 해상도 향상

  • 입력: 저해상도 이미지, 확대 비율, 품질 설정
  • 출력: 고해상도 이미지

유틸리티 도구

  • optimize_prompt: 이미지 생성 프롬프트 최적화
  • 입력: 기본 프롬프트, 스타일 힌트
  • 출력: 최적화된 프롬프트

  • list_models: 사용 가능한 모델 목록 조회

  • 입력: 필터링 기준(선택적)
  • 출력: 모델 목록 및 설명

  • get_model_params: 특정 모델의 매개변수 조회

  • 입력: 모델 ID
  • 출력: 매개변수 목록 및 기본값

사용 방법

설치

# npm을 통한 설치
npm install -g image-generation-mcp

# 또는 GitHub 저장소에서 직접 설치
git clone https://github.com/author/image-generation-mcp
cd image-generation-mcp
npm install

필요 조건

  • Replicate API 키가 필요합니다.
  • Node.js 14 이상이 설치되어 있어야 합니다.

구성

Claude Desktop에서 이 서버를 사용하려면 다음과 같이 설정할 수 있습니다:

{
  "mcpServers": {
    "image-generation": {
      "command": "npx",
      "args": ["-y", "image-generation-mcp"],
      "env": {
        "REPLICATE_API_KEY": "YOUR_API_KEY",
        "OUTPUT_DIRECTORY": "/path/to/output"
      }
    }
  }
}

사용 예시

// 기본 이미지 생성
const image = await generate_image({
  prompt: "한국 전통 한옥이 있는 산속 마을, 안개가 자욱한 아침, 사실적 스타일",
  width: 1024,
  height: 768,
  model: "stability-ai/sdxl",
  parameters: {
    num_inference_steps: 50,
    guidance_scale: 7.5
  }
});

console.log(`이미지 생성 완료: ${image.url}`);

// 스타일 전이 적용
const styledImage = await style_transfer({
  content_image: "/path/to/photo.jpg",
  style_prompt: "반 고흐의 별이 빛나는 밤 스타일",
  strength: 0.8
});

console.log(`스타일 적용 완료: ${styledImage.url}`);

// 배치 처리로 여러 변형 생성
const prompts = [
  "산 속 전원 주택, 가을, 해질녘",
  "산 속 전원 주택, 겨울, 눈 내리는 아침",
  "산 속 전원 주택, 봄, 꽃이 만발한 정오"
];

const batchResults = await batch_generate({
  prompts: prompts,
  width: 768,
  height: 768,
  model: "stability-ai/sdxl"
});

console.log(`${batchResults.length}개의 이미지가 생성되었습니다.`);

연결된 구성 요소

  • EverArt - 다양한 AI 이미지 생성 모델과의 통합
  • Blender - 생성된 이미지를 3D 텍스처 및 참조로 활용
  • Office-PowerPoint-MCP-Server - 생성된 이미지를 프레젠테이션에 통합
  • YouTube - 생성된 이미지로 썸네일 및 비디오 자산 제작